home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / gen / fount040 / fountain.doc < prev    next >
Text File  |  1993-10-10  |  6KB  |  128 lines
  1.                                  
  2.                                  
  3.                                  
  4.                                  
  5.                                  
  6.                                  
  7.                                  
  8.                                  
  9.                                  "FOUNTAIN"
  10.                                 Version 0.40
  11.                                      By:
  12.                                Jason Mussetter
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.    "FOUNTAIN" is a simple particle fountain generator that was originally
  25. written for Steven Coy's "VIVID", but it now supports POV-Ray and PolyRay
  26. also.  Release 0.40 is the current release of "FOUNTAIN", but other beta
  27. releases will be released later.
  28.  
  29. USAGE:
  30.  
  31.         FOUNTAIN /<option>
  32.  
  33.    The current command line options are:
  34.  
  35.         /? - help; displays all the command line options along with their
  36.              default values
  37.         /o - output select; choices are:  VIVID, POV-Ray, and PolyRay
  38.         /v - velocity of the particles, the higher the number the further
  39.              the particles come out
  40.         /a - angle that the particle exits
  41.         /l - random allowance; shoots the particles with a random angle
  42.         /d - particle dissolve; shrinks the particle a given amount
  43.              every frame
  44.         /g - gravity strength;  earths gravity strength is 9.8
  45.         /m - minimum distance; simulates the particles hitting a "floor"
  46.         /n - the origin (x y z) of the fountain;
  47.         /t - time (# of frames); maximum of 400 frames for current version
  48.         /p - particle count
  49.         /r - particle radius
  50.         /h - threshold of blob;  only works with the /o option
  51.         /e - strength of blob;  only works with the /o option
  52.         /y - rotation of the fountain; 180 will make a half fountain, etc.
  53.         /c - scale of scene; the bigger the number the smaller the scene
  54.         /i - include statement
  55.         /s - surface definition
  56.         /w - preview; will show you the path of the particles on the
  57.              screen without writing to disk
  58.  
  59.    To use the command line options, you enter "FOUNTAIN" and as many of the
  60. option switches as you wish (NOTE:  **DO NOT** enter the actual option
  61. values at the command line, the program will prompt you for them when needed).
  62. You can use as many options as you wish.
  63.  
  64. TIPS:
  65.  
  66.    The /i option is very useful and should be used in all scenes.  For best
  67. results, create a vivid file called "CAMERA.V" or something similar and
  68. put the camera definitions in this file.  Then, when using fountain, use
  69. the /i option and enter "#include CAMERA.V" when prompted (this is now
  70. the default), this will create each frame with the camera definitions
  71. already in it, the alternative way is to type in all of the camera definitions
  72. for each frame individually.
  73.  
  74.    The /s option is also very useful.  When you use this, you can either
  75. enter the actual surface definition, something like "SURFACE {DIFF 1 0 0}"
  76. or something similar, or you can define a surface in the "CAMERA.V" file,
  77. using the "#DEFINE" command, and just put the name in when the program prompts
  78. you for one.  **NOTE**  You must use this option as well as the /i
  79. option when outputing to POV or PolyRay.
  80.  
  81.    The /c option is useful when the output scene you make is too big and
  82. you can't fit all the particles in the shot unless you have you camera
  83. way far away (ie: 0,100000,0) which happens alot, so you can scale your
  84. scene down to a better size.
  85.  
  86.    The /l option will give the fountain a nice random look to it.  The
  87. random allowance is the maximum number of degrees that can be added to
  88. the original angle to determine what the random angle will be.  For
  89. example, suppose that you made the exit angle of the particles 10, and
  90. you used the /l option and entered 80 for the Random Allowance.  This
  91. will cause all the particles to shoot out at a random angle between 10
  92. and 90 (10 + 80).  If you still don't unterstand, play around with it
  93. and see the results.  **NOTE**  A bug was found in this option which
  94. causes it to shoot the particles in 360 degrees know matter what the RA
  95. is.  Working on this, hopefully I will have figured out what is caused
  96. this by the next version.
  97.  
  98.    The /m option which is the long awaited Aritificial Collision
  99. Detection parameter might still be a little buggy.  I tested it a couple
  100. of times with a few *SIMPLE* animations and it looked like it was doing
  101. what it was supposed to do.  However, if you find and bugs in it with
  102. more complex animations, please inform me.
  103.  
  104.    When using the /o option, you must remember that FOUNTAIN uses the
  105. right-handed coordinate system when outputting to VIVID, and the
  106. left-handed coordinate system when outputting to POV-Ray and PolyRay.
  107. So be careful when defining "up" in the CAMERA definition in these programs,
  108. otherwise you may end up with a sideways fountain.  Also note that when
  109. outputting to POV-Ray and PolyRay, you must costomize the surface and
  110. include options, otherwise it will be in VIVID syntax, thus producing a
  111. error while tracing.
  112.  
  113.    
  114.    
  115.    
  116.  
  117. NOTES:
  118.  
  119.    That's about it for now, as I said before, the program is only a beta
  120. version right now.  If you find any program bugs, or have any ideas or
  121. questions, please contact me here at The Graphics Alternative.  I will continue
  122. to add and change features in later releases.  Some of the things I'm planning
  123. on adding are:  output to other raytracers, and a higher frame count so your
  124. not limited to 400 frames.  I would also like to give special thanks to
  125. Darby Johnston for answering my tough questions about particle
  126. animation, and Adam Shiffman for some great suggestions.  Good luck, and have
  127. fun, and don't forget to keep looking for newer releases of "FOUNTAIN"!
  128.